1. 前置知识：什么是数据库驱动？ #

数据库驱动（Driver）是一个程序库，它让你的编程语言（比如 Python）能够和数据库（比如 Neo4j）进行通信。就像翻译官一样，它把 Python 的指令翻译成数据库能理解的语言。

2. 安装 Neo4j 数据库 #

Neo4j 有几种安装方式，对于新手来说，最简单的是使用 Neo4j Desktop 或 Docker。

2.1 方式一：使用 Neo4j Desktop（推荐新手） #

1. 访问 Neo4j 官网 下载 Neo4j Desktop
2. 安装后创建一个新的数据库项目
3. 启动数据库，记住用户名和密码（默认用户名是 neo4j）

特点：

• 图形化界面，易于使用
• 可以管理多个数据库项目
• 内置数据库浏览器
• 支持插件和扩展

适合： 本地开发和学习

2.2 方式二：使用 Docker（适合有 Docker 经验的用户） #

# 运行 Neo4j Docker 容器
docker run \
    --name neo4j \
    -p7474:7474 -p7687:7687 \
    -e NEO4J_AUTH=neo4j/password \
    neo4j:latest

端口说明：

• 7474:7474：HTTP 端口
  • Neo4j 浏览器访问地址：http://localhost:7474
  • 用于 Web 界面管理
• 7687:7687：Bolt 协议端口
  • 应用程序连接端口
  • 支持 Cypher 查询语言

认证设置：

• 格式：用户名/密码
• 默认用户：neo4j
• 首次登录需要修改密码
• 安全提示：生产环境不要使用简单密码！

3. 安装 Python 驱动 #

在 Python 中使用 Neo4j，需要安装 neo4j 驱动包。

# 使用 pip 安装
pip install neo4j

4. 连接 Neo4j 数据库 #

下面是一个完整的连接示例，展示了如何用 Python 连接到 Neo4j 数据库。

# 导入 Neo4j 驱动库
from neo4j import GraphDatabase

# 定义 Neo4j 数据库的连接地址
URI = "bolt://localhost:7687"
# 定义用户名
USERNAME = "neo4j"
# 定义密码（替换为你自己的密码）
PASSWORD = "your_password"

# 创建数据库驱动对象，用于连接 Neo4j
driver = GraphDatabase.driver(URI, auth=(USERNAME, PASSWORD))

# 尝试连接数据库，如果连接失败会捕获异常
try:
    # 验证与 Neo4j 数据库的连接
    driver.verify_connectivity()
    # 如果连接成功，打印提示信息
    print("成功连接到 Neo4j 数据库！")
except Exception as e:
    # 如果连接失败，输出失败信息和异常原因
    print(f"❌ 连接失败：{e}")

# 关闭数据库连接，释放资源
driver.close()

重要提示： 如果连接失败，检查：

1. Neo4j 数据库是否已启动
2. 端口号是否正确（默认是 7687）
3. 用户名和密码是否正确
4. 防火墙是否阻止了连接

5. Neo4j 常用工具 #

5.1 Neo4j Browser（浏览器界面） #

用途： 执行 Cypher 查询、可视化结果、学习 Neo4j

特点：

• 免费的 Web 界面
• 可以直接在浏览器中执行查询
• 自动可视化查询结果
• 内置教程和示例

如何使用：

1. 启动 Neo4j 数据库
2. 打开浏览器访问 http://localhost:7474
3. 输入用户名和密码（默认是 neo4j）
4. 开始执行查询

5.2 Neo4j Desktop（桌面应用） #

用途： 本地开发、数据库管理

特点：

• 图形化界面，易于使用
• 可以管理多个数据库项目
• 内置数据库浏览器
• 支持插件和扩展

适合： 本地开发和学习

5.3 Python 驱动（neo4j 包） #

用途： 在 Python 程序中连接和操作 Neo4j

基本使用：

# 导入驱动
from neo4j import GraphDatabase

# 连接数据库
driver = GraphDatabase.driver("bolt://localhost:7687", 
                              auth=("neo4j", "password"))

# 执行查询
with driver.session() as session:
    result = session.run("MATCH (n) RETURN count(n) AS count")
    print(result.single()["count"])

# 关闭连接
driver.close()

5.4 其他工具（了解即可） #

以下工具在生产环境中常用，但新手可以暂时忽略：

• Neo4j Aura：云托管服务（需要付费）
• Bloom：商业可视化工具（需要付费）
• Neo4j ETL：数据导入工具（适合大数据迁移）

6. 小结 #

6.1 安装步骤总结 #

1. 安装 Neo4j 数据库：使用 Neo4j Desktop 或 Docker
2. 安装 Python 驱动：pip install neo4j
3. 连接数据库：使用 GraphDatabase.driver() 创建连接
4. 验证连接：使用 driver.verify_connectivity() 测试连接

6.2 常用工具 #

• Neo4j Browser：Web 界面，执行查询和可视化
• Neo4j Desktop：桌面应用，管理数据库项目
• Python 驱动：在 Python 程序中操作 Neo4j